[[PageOutline(3-4, Sections)]]

== GetIMDBMovieDetails == 

=== Intro ===

  get details about given movie


----
=== Description ===

  '''struct GetIMDBMovieDetails(string $token, string $imdbid)'''
  
  Returns structure with movie information about given movie $imdbid containing movie title, release year, directors, cast, ...
  
  All information is gathered from [http://www.imdb.com IMDb].


----
=== Parameters ===

{{{
struct(
  (string) [token],
  (string) [imdbid]
)
}}}

  ''token (required)''::
    token string identifying user's session, taken from [wiki:XmlRpcLogIn LogIn] output structure.
  ''imdbid (required)''::
    IMDb ID of requested movie, can be taken from results of [wiki:XmlRpcSearchMoviesOnIMDB SearchMoviesOnIMDB()]


----
=== Return Values ===

  Output is returned in this structure:
   
{{{
struct(
  (string) [status],
  struct(
    (string) [id],
    (string) [title],
    (string) [year],
    (string) [cover],
    struct(
      (string) [<id>], (string) [id], ...
    ) [cast],
    struct(
      (string) [<id>], (string) [id], ...
    ) [directors],
    struct(
      (string) [<id>], (string) [id], ...
    ) [writers],
    (string) [awards],
    array(
      (string) [genre], (string) [genre], ...
    ) [genres],
    array(
      (string) [country], (string) [country], ...
    ) [country],
    array(
      (string) [language], (string) [language], ...
    ) [language],
    (string) [duration],
    array(
      (string) [certification], (string) [certification], ...
    ) [certification],
    (string) [tagline],
    (string) [plot],
    (string) [goofs],
    (string) [trivia],
    (string) [request_from]
  ) [data],
  (double) [seconds]
)
}}}

  and contains these elements:
    ''status''::
      function result code, see [wiki:XmlRpcStatusCode list of status codes]
    ''data''::
      structure containing movie information
    ''seconds''::
      time taken to execute this command on server


----
=== Implementations ===

  There are currently no available sample implementations.


----
=== Changelog ===

  Version 1: created this function


----
=== Examples ===


==== Input ====
  
{{{
#!xml
<methodCall>
 <methodName>GetIMDBMovieDetails</methodName>
 <params>
  <param>
   <value><string>d0iot4l0teqk9nmn3s99bdhsh3</string></value>
  </param>
  <param>
   <value><string>0088763</string></value>
  </param>
 </params>
</methodCall>
}}}

  
==== Output ====

This structure might be incomplete (or extended later).

Not sure if these values are returned: rating, aka.

{{{
#!xml
<methodResponse>
 <params>
  <param>
   <value>
    <struct>
     <member>
      <name>status</name>
      <value><string>200 OK</string></value>
     </member>
     <member>
      <name>data</name>
      <value>
       <struct>
        <member>
         <name>id</name>
         <value><string>0088763</string></value>
        </member>
        <member>
         <name>title</name>
         <value><string>Back to the Future</string></value>
        </member>
        <member>
         <name>year</name>
         <value><string>1985</string></value>
        </member>
        <member>
         <name>cover</name>
         <value><string>http://ia.media-imdb.com/images/M/MV5BMTkzNDQyMjc0OV5BMl5BanBnXkFtZTcwNDQ4MDYyMQ@@._V1._SX100_SY133_.jpg</string></value>
        </member>
        <member>
         <name>cast</name>
         <value>
          <struct>
           <member>
            <name>_0000150</name>
            <value><string>Michael J. Fox</string></value>
           </member>
           <member>
            <name>_0000502</name>
            <value><string>Christopher Lloyd</string></value>
           </member>
           <member>
            <name>_0000670</name>
            <value><string>Lea Thompson</string></value>
           </member>
           
           ... more cast members go here (if any) ...
            
          </struct>
         </value>
        </member>
        <member>
         <name>directors</name>
         <value>
          <struct>
           <member>
            <name>_0000709</name>
            <value><string>Robert Zemeckis</string></value>
           </member>
           
           ... more directors go here (if any) ...
           
          </struct>
         </value>
        </member>
        <member>
         <name>writers</name>
         <value>
          <struct>
           <member>
            <name>_0000709</name>
            <value><string>Robert Zemeckis</string></value>
           </member>
           <member>
            <name>_0301826</name>
            <value><string>Bob Gale</string></value>
           </member>
          </struct>
         </value>
        </member>
        <member>
         <name>awards</name>
         <value><string>Won Oscar. Another 12 wins &#38; 22 nominations</string></value>
        </member>
        <member>
         <name>genres</name>
         <value>
          <array>
           <data>
            <value><string>Adventure</string></value>
            <value><string>Comedy</string></value>
            <value><string>Sci-Fi</string></value>
            
            ... more genres go here (if any) ...
            
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>country</name>
         <value>
          <array>
           <data>
            <value><string>USA</string></value>
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>language</name>
         <value>
          <array>
           <data>
            <value><string>English</string></value>
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>duration</name>
         <value><string>117 min</string></value>
        </member>
        <member>
         <name>certification</name>
         <value>
          <array>
           <data>
            <value><string>UK</string></value>
            <value><string>Italy</string></value>
            <value><string>Australia</string></value>
            <value><string>USA</string></value>
           </data>
          </array>
         </value>
        </member>
        <member>
         <name>tagline</name>
         <value><string>He's the only kid ever to get into trouble before he was born. [UK]</string></value>
        </member>
        <member>
         <name>plot</name>
         <value><string>In 1985, Doc Brown invented time travel, in 1955, Marty McFly accidentally prevented his parents from meeting, putting his own existence at stake.</string></value>
        </member>
        <member>
         <name>goofs</name>
         <value><string>Continuity: A picture on the table below Biff, and the candy in Biff's hand when he is talking to George about his car in 1985.</string></value>
        </member>
        <member>
         <name>trivia</name>
         <value><string>The space alien gag first appeared in the screenplay's third draft, with the primary difference being that it was to be done to Biff.</string></value>
        </member>
        <member>
         <name>request_from</name>
         <value><string>cache</string></value>
        </member>
       </struct>
      </value>
     </member>
     <member>
      <name>seconds</name>
      <value><double>0.535</double></value>
     </member>
    </struct>
   </value>
  </param>
 </params>
</methodResponse>
}}}


----
=== Notes ===

  none yet


----
=== See also ===

  * [wiki:XmlRpcSearchMoviesOnIMDB SearchMoviesOnIMDB()]


----
=== Comments ===

	add your comments, hints and suggestions here if you like ...


--------
[Prev] [wiki:XmlRpcIntro Home] [Next]